SViewBase for Android 集成说明书

SViewBase for Android 提供三维模型基本的浏览、模型属性操作、基本三维对象操作、动画播放、测量、批注等功能的实现接口，可实现基本的三维模型展示功能，以便于用户个性化定制属于自己的产品。

需要快速集成使用的用户，可选择有基本功能界面的控件版本 SViewFrame for Android 集成控件进行集成。

集成之前需要熟悉集成环境以便快速准确的集成相关功能界面。详细集成准备如下所示:

集成环境

SViewBase for Android 开发库集成需要的环境：

开发环境：JDK7或以上版本
开发工具：Android Studio或Eclipse
运行环境: Android 8.0及以上的设备

SDK包解压SDK后得到以下内容：

其中， Android Studio 文件夹包含了Android Studio所需的文件;Doc文件夹为SDK相关文档; Demo包含了Android Studio演示工程

Android Studio集成

控件资源

Android studio文件夹下的sviewbase.aar及HUAWEI AR Engine SDK_v2.0.0.aar文件为控件资源

资源导入

打开Android Studio，将sviewbase.aar添加到您工程的libs文件夹下,如图所示。

修改app的build.gradle 配置文件

{
repositories {
flatDir {
    dirs 'libs'
    }
}

添加一个本地仓库，并把libs目录作为仓库的地址。修改dependencies：添加sviewbase及华为arEngine依赖, 其中name就是libs目录下sviewbase.aar文件名称;

dependencies {

    api(name: 'sviewbase', ext: 'aar')
    //内部使用了华为ar,需要添加依赖;
    api(name: 'HUAWEI AR Engine SDK_v2.0.0', ext: 'aar')
}

选择你的project 鼠标右键选择【open Module Settings】

选择你的module Dependencies 选项卡，选择+号，选择【File dependency】 找到需要导入的jar包，点击ok

点击Rebuild Project按钮重新构建工程

注意事项：

若遇到aapt finished with non-zero exit value 1 异常，请将SDK的build.gradle中的 buildToolsVersion 设置为与app中build.gradle文件的buildToolsVersion相同，然后Rebuild Project。;
若遇到module 合并时的重名冲突问题，请尝试重命名冲突的文件并Rebuild Project;
如果提示：mergeDebugResources AAPT err,你可以在app 下的build.gradle 文件下添加
```
aaptOptions.cruncherEnabled = false
aaptOptions.useNewCruncher = false
```

主体功能集成

应用权限声明

由于控件需要SDCard读写，录音等权限，请在AndroidManifest里面加入如下权限配置：

<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.CHANGE_CONFIGURATION" />
//OpenGLES 渲染器版本设定
<uses-feature android:glEsVersion="0x00020000" />

控件资源初始化

在创建SViewBase控件对象之前，需要初始化SViewBase所需的本地资源，OpenGLES版本等信息。此过程一般在Application中进行，基本流程如下，此代码可以从Demo工程拷贝，根据需要做配置修改。

/**
* 初始化SView参数
*/
public void initSViewBaseConfig () {
   String assertDataPath = "SViewData";
        UIHelper.setDefaultContext(this);
        if (SDCardHelper.ExistSDCard()) {
            appWorkingPath = SDCardHelper.getSDRootDir() + "Dsoft/" + NAME;
        } else {
            appWorkingPath = Environment.getRootDirectory().getPath()
                    + "/Dsoft/" + NAME;
        }
        /**
         * appWorkingPath: 设置的工作路径,一般在/android/data/xxx包名/files/下
         * assertDataPath: 资源文件的文件夹名;
         * GLES版本号;
         */
        SView.initSDK(this, appWorkingPath, assertDataPath, SViewConfig.GLESVERSION20);
}

申请授权文件sview.lic,在第一次运行时拷贝到工作目录/data文件夹下; 或者参考demo中写法,放在Asserts/SViewData/data文件夹下,在assets.lst中添加 data/sview.lic。申请授权地址

调用控件方法

SView对象支持通过xml布局文件和代码两种方式初始化，这里提供通过xml布局文件初始化的流程，详细使用请参考Demo工程。

view1 = (SView) findViewById(R.id.sview_view_view);

常见问题

集成控件后，能够显示菜单但是模型显示界面为黑色。

这是由于SViewBase所依赖的C++动态库，没有打包进入您的apk导致，请清理工程重新生成apk再试。

集成控件出现打开模型空白或者没有授权。

可能的原因有两个：

1).授权时间到期。请重新申请更新授权信息。

2).so文件读取异常。集成初期一般为这个原因，请检查是否存在多个存在so文件的文件夹：如同时存在x86.armeabi,armeabi-v7a,armeabi-v8a....，建议在性能要求不过分要求的情况下只保留armeabi-v7a即可。

3).运行设备系统为64位导致。可以在项目的gradle中增加强制使用armv7a下的so文件并使用32位集成控件,或者集成含arm64-v8a的64位控件。参考代码如下：

defaultConfig {
    ndk{
       abiFilters "armeabi-v7a"//使用32位集成控件;
       //abiFilters "armeabi-v7a","arm64-v8a"//使用64位集成控件;
    }
}

查看SViewBase接口文档